<?php

namespace app\admin\controller;

/**
 * @title 学校招生详情
 * @description 接口说明
 * @group admin
 * @header name:authorization require:1 default: desc:登陆的token
 */

class SchoolDetail extends Base
{
        protected $_order = 'year asc';

    /**
     * @title 获取学校招生详情(get)
     * @description 接口说明
     * @author wang
     * @url /admin/SchoolDetail
     * @method GET
     *
     * @param name:speciality_id type:int require:1 default:0 other: desc:专业的id
     * @param name:page type:int require:0 default:1 other: desc:页码数 获取第二页以上的数据必填，默认值为1，id和page选填其一
     * @param name:size type:int require:0 default:20 other: desc:每一页的数量，默认20

     *
     * @return speciality_id:学校招生详情的id
     * @return name:学校招生详情的名字
     * @return create_time:创建时间
     *
     * @return list:消息列表,有page参数则返回值list，list是一个数组，
     * @return size:每页最大数，默认20，可由前端传递参数决定 page参数返回值，
     * @return page:当前页，page参数返回值，
     * @return count:总记录数， page参数返回值，
     */
    public function gets()
    {

        parent::gets();
    }
    protected function _searchPage(&$where)
    {
        $id = input('get.id');
        if (!empty($id)) {
            $where[] = ["id", '=', $id];
        }
        $speciality = input('get.speciality_id');
        if (!empty($speciality)) {
            $where[] = ["speciality_id", '=', $speciality];
        }

    }
    /**
     * @title 创建学校招生详情 (post)
     * @description 创建学校招生详情
     * @author wang
     * @url /admin/SchoolDetail
     * @method POST
     *
     *
     * @param name:year type:int require:1 default: other: desc:报考年份
     * @param name:bk_num type:int require:0 default: other: desc:报考人数
     * @param name:zs_num type:int require:0 default: other: desc:招生人数
     * @param name:lq_num type:int require:0 default: other: desc:录取人数
     * @param name:tm_num type:int require:0 default: other: desc:推免人数
     * @param name:propotion type:float require:0 default: other: desc:报录比
     * @param name:retest_score type:float require:0 default: other: desc:复试分数
     * @param name:max_score type:float require:0 default: other: desc:录取最高分
     * @param name:min_score type:float require:0 default: other: desc:录取最低分
     * @param name:ave_score type:float require:0 default: other: desc:录取平均分
     * @param name:speciality_id type:int require:1 default: other: desc:专业id
     * @param name:speciality_max_score type:float require:0 default: other: desc:专业课最高分
     * @param name:speciality_min_score type:float require:0 default: other: desc:专业课最低分
     * @param name:speciality_sort type:int require:0 default: other: desc:专业排名
     * @param name:adjust_num type:int require:0 default: other: desc:调剂名额
     * @param name:first_list type:json require:0 default: other: desc:初试科目
     * @param name:retest_list type:json require:0 default: other: desc:复试科目
     * @param name:booklist type:json require:0 default: other: desc:参考书目
     * @param name:community type:string require:0 default: other: desc:研友互助
     * @param name:comment type:string require:0 default: other: desc:备注
     *
     * @return size:每页最大数，默认20，可由前端传递参数决定 page参数返回值，
     * @return page:当前页，page参数返回值，
     * @return count:总记录数， page参数返回值，
     * @return list:消息列表,有page参数则返回值list，list是一个数组@
     * @list id:省及地区的id name:省及地区的名字 create_time:创建时间
     */
    public function create(){


        parent::create();
    }
    /**
     * @title 修改学校招生详情（put）
     * @description 修改学校招生详情
     * @author wang
     * @url /admin/SchoolDetail
     * @method put
     *
     *
     * @param name:id type:int require:1 default: other: desc:学校招生详情id
     * @param name:name type:string require:1 default: other: desc:学校招生详情名称
     * @param name:page type:int require:1 default: other: desc:当前信息所在页面
     * @param name:size type:int require:1 default:0 other: desc:每页多少条信息
     *
     * @return list:消息列表,有page参数则返回值list，list是一个数组，
     * @return size:每页最大数，默认20，可由前端传递参数决定 page参数返回值，
     * @return page:当前页，page参数返回值，
     * @return count:总记录数， page参数返回值，
     */
    public function update(){
        parent::update();
    }
    /**
     * @title 删除学校招生详情（delete）
     * @description 删除学校招生详情
     * @author wang
     * @url /admin/SchoolDetail
     * @method delete
     *
     * @param name:id type:int|string|array require:1 default: other: desc:单个删除：数字，多组删除：","隔开的数字或者数组
     */
    public function delete(){
        parent::delete();
    }
}
